
First Time Perlshop 4 Installation Instructions

1:	Download and install Perlshop 3 from the Arpanet web site: http://www.arpanet.com

2:	Unzip the Perlshop 4 zip archive.

3:	Copy the country.html file, all js files, and all css files from the zip archive to your main html directory.  
This will be the directory where your index.html file is.  Make sure these files are copied to your server in ASCII mode.

4:	Copy the orderfaq.html file into your catalog directory.  Make sure this file is copied to your server in ASCII mode.  Once it has been installed, you MUST alter the contents of your copy of this file to suit your business model.

5:	Create a new directory called "credit" under your server images directory.  Copy all of the credit card image files into this directory.  Make sure these files are copied to your server in binary mode.

6:	Copy all files with 'cgi', 'pl', and 'pm' suffixes to your CGI directory.  Make sure these files are transferred in ASCII mode.  

7.	Use a text editor to change the first line of the perlshop.cgi file to reflect the local conditions at your ISP.

8:	Copy the ps.cfg, and the CLEAN file from the zip archive to your CGI directory.  Make sure these files are copied to your server in ASCII mode.

9:	Change the very first line of the perlshop.cgi file to reflect the local conditions at your ISP.  This is detailed in the Perlshop 3 manual.

10:	Alter the configuration settings in the ps.cfg file to suit the needs of your store.  All settings are documented inside the cfg file.  Many settings are also discussed in detail in the Perlshop 3 manual.



Upgrading from a Previous Version of Perlshop 4

1:	Unzip the Perlshop 4 zip archive.

2:	Copy the country.html file, all js files, and all css files from the zip archive to your main html directory.  
This will be the directory where your index.html file is.  Make sure these files are copied to your server in ASCII mode.

3:	Copy all files with 'cgi', 'pl', and 'pm' suffixes to your CGI directory.  Make sure these files are transferred in ASCII mode.  

4.	Use a text editor to change the first line of the perlshop.cgi file to reflect the local conditions at your ISP.

5:	Change the very first line of the perlshop.cgi file to reflect the Perl installation of your ISP.  This is detailed in the Perlshop 3 manual.

6:	Read the release notes below.  Make any necessary changes or additions to your EXISTING ps.cfg file.


-------------------------------------------------------------------------------
Version History

Perlshop 4.2 Release Version, Service Pack 5 (4.2.05)
29 August 2000
This release pertains to the Perlshop Search module (ps_search.pl) only.  
This library module has been upgraded from version 1.0 to version 1.1.

The following features have been added:
1.	Search result pages are now displayed by page title, not page file name.  The page title is copied from the <title>
	tags of the page in question, if present.  If no title can be found, the page file name will be used.
2.	Search results are sorted alphanumerically by page title.
	

-------------------------------------------------------------------------------
Perlshop 4.2 Release Version, Service Pack 4 (4.2.04)
14 July 2000

The following minor features have been added:
1.	Optional $top_logo setting now supported by ps.cfg file.

The following minor bugs have been repaired:
1.	Case insensitivity added to tax table state check.
	

-------------------------------------------------------------------------------
Perlshop 4.2 Release Version, Service Pack 3 (4.2.03)
25 June 2000

The following minor features have been added:
1.	Real-time transaction related code was moved into an external library file called ps_transact.pl.
2.	QuickBuy mode has been formally released. 
	

-------------------------------------------------------------------------------
Perlshop 4.2 Release Version, Service Pack 2 (4.2.02)
This version was released only to test sites.

The following minor features have been added:
1.	Back-end only mode was added to this release. (This may be removed in a future version)
2.	Additional support for the PSDBI package was added to this release.
3.	Search related code was moved into an external library file called ps_search.pl.
	

-------------------------------------------------------------------------------
Perlshop 4.2 Release Version, Service Pack 1 (4.2.01)
This version was released only to test sites.

The following minor bugs have been corrected:
1.	An http header generation problem was repaired.  This bug only occured if cookies were enabled and the order ID value had become corrupted.

The following minor features have been added:
1.	The QuickBuy mode prototype was added to this release.
	

-------------------------------------------------------------------------------
Perlshop 4.2 Release Version (4.2.00)
26 May 2000

This version of Perlshop brings on-line transaction processing back to life for Perlshop.

Supported on-line transaction approval mechanisms are:
	- MerchanTrust Global Commerce 2000, by Merchant Commerce 
	(www.merchanttrust.com) (formerly ATS Bank)
	Credit cards and virtual checks are both supported.
	
	- EFT Secure, by Network 1 Financial
	(used by Charge.com)
	Credit cards and virtual checks are both supported.

This version of Perlshop has full support for the Perlshop Database Interface package, including catalog page templates.

The following minor features have been added:
1.	A 'Continue Shopping' link is now present on the Shipping Rates page.
	

-------------------------------------------------------------------------------
Perlshop 4.1 Release Version, Service Pack 3 (4.1.04)
20 May 2000

This version contained preliminary test support for MerchanTrust credit card processing,
and was only released to test sites.


-------------------------------------------------------------------------------
Perlshop 4.1 Release Version, Service Pack 3 (4.1.03)
12 May 2000

The following bug has been corrected:
1.	Tax Type value of 'none' is now working correctly.


-------------------------------------------------------------------------------
Perlshop 4.1 Release Version, Service Pack 2 (4.1.02)
6 May 2000

Support for PayPal has been added to this release:
1.	PayPal is now listed as a possible payment method in the ps.cfg file.
2.	If PayPal is an accepted payment mode, a PayPal logo will be displayed along with the various credit card logos at the 
top of the order page.  This logo image is supplied as a part of this zip archive.
3.	If the chosen payment method is PayPal, instructions on making payment are displayed at the top of the final invoice page.


The following minor features have been added:
1.	Perlshop 4 now supports a called to an external user supplied order post-processing plugin program.
2.	If the customer credit card information is to be sent by email, only the store copy of the email includes this data.


Additional:
1.	The existing order completion software has been enhanced for efficiency.
2.	Improved file error checking has been added to the existing order completion software.


-------------------------------------------------------------------------------
Perlshop 4.1 Release Version, Service Pack 1 (4.1.01)
28 April 2000

The following minor features have been added:
1.	Period characters are now ignored during the state code validity check.
2.	The Perlshop logo image can be specified via the new $perlshop_logo setting in the ps.cfg file.
	Default behavior is to use the image file that was hard-coded in previous versions.
3.	Perlshop and Waverider Systems logo images are now included in the Perlshop 4 zip archive.
4.	A new section on internal security control, including two new settings and related documentation, 
	has been added to the ps.cfg file.  
5.	The log file locking mechanism has been improved to eliminate a potential time-out.
6.	The keyword 'OTHER' has been added as an optional value for the Tax_States table.


-------------------------------------------------------------------------------
Perlshop 4.1 Release Version
8 April 2000

The following bug has been corrected:
1.	The return shopper cookie now displays the year as a full 4 digit value.


Additional:
1.	The PSDBI interface to PS4 is now stable and complete.


-------------------------------------------------------------------------------
Perlshop 4 Beta 7

The following feature has been added:
1.	The number '0000 0000 0000 0000' is now considered valid for all types of credit card.  This is intended for diagnostic testing of new PS installations.


The security section of the ps.cfg file has seen the following additions:
1.	The new $secure_server_domain setting is needed to support Perlshop Office.


The following bugs have been corrected:
1.	The 'Shipping Rates' links and buttons do not display if the shipping type is set to 'none'.
2.	The 'credit card on email' feature was broken during Beta 5.  It has been fixed.


Additional:
1.	The Plugin API was altered to make it simpler to configure plugins.
2.	Beta 7 contains the support infrastructure needed for the PSDB project.  No functional changes related to this support infrastructure are present in this release.


-------------------------------------------------------------------------------
Version Changes

Perlshop 4 Beta 6

The following bugs have been corrected:
1.	Countries with no states or provinces are now handled correctly during checkout.
2.	The $catalog_home value is used with the "Return to Home Page" button on the final invoice screen.


The email section of the ps.cfg file has seen the following additions:

# Include invoice number in the subject of both customer and store copies of 
# the email?    ('yes' or 'no')
$email_id_in_subject        = 'yes';

# Include store name in the subject of both customer and store copies of 
# the email?    ('yes' or 'no')
$email_storename_in_subject = 'yes';

# Include customer last name in the subject of the store copy of the email?
# ('yes' or 'no')
$email_lastname_in_subject  = 'yes';	



-------------------------------------------------------------------------------
Version Changes

Perlshop 4 Beta 5


The ps.cfg file has seen the following modifications:
1.	The $secure_image_directory value has been moved up to be with the other secure server settings.
2.	A new setting named $secure_css_directory has been added.  This works just like the $secure_image_directory value, except that it is used by Perlshop to reference .css files on a secure server.
3.	A new setting named $secure_script_directory has been added.  This works just like the $secure_image_directory value, except that it is used by Perlshop to reference .js files on a secure server.
4.	The global style sheet value is now just a single file name, not a full file path.


Perlshop has had the following modifications made to it:
1.	When running on a secure server, all .css and .js files are now automatically referenced by secure server URL.
2.	The secure server process begins with the checkout page, and stays enabled all the way through the end of the ordering process.
3.	The format of the customer invoice has been improved for clarity.  No changes have been made to information content.
4.	The Perlshop check for valid state code values now includes Canadian provinces and territories.
5.	Diagnostic information content for Transmission Errors 5 and 6 has been improved


Perlshop has had the following cosmetic changes made to it:
1.	All credit card images have been replaced with superior graphics.  Also, there is now an image for the JCB card.  Please replace your existing credit card images with the new ones from this zip file.


The following bugs have been corrected:
1.	The orderfaq.html file now references the correct style sheet URL.
2.	The country.html file now references the correct style sheet URL.
3.	The order form now displays correctly for businesses that do not accept credit cards.




-------------------------------------------------------------------------------

Legal Stuff:

This software is a custom modification of Perlshop v3.1.
Any alterations that differ this source code from Perlshop release 3.1
are the sole property of David M. Godwin, and may not be used for any purpose 
without his express written permission.

Understand: This is not open source code.  This is not shareware.


This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.




